home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Freeware / Griffith 0.9.8 / griffith-0.9.8-win32.exe / {app} / INSTALL < prev    next >
Text File  |  2008-11-17  |  7KB  |  165 lines
  1. 1. UNIX systems
  2. ===============
  3.  
  4. 1.1 Installing on some Linux distributions
  5.  
  6.     1.1.1 Debian GNU/Linux and Ubuntu
  7.  
  8.         # aptitude install griffith
  9.     
  10.     1.1.2 Arch Linux
  11.         
  12.         # pacman -S griffith
  13.  
  14.     1.1.3 Gentoo Linux
  15.  
  16.         # emerge -a griffith
  17.  
  18. 1.2 Installing from source
  19.  
  20.     Unpack the Griffith tarball using these commands:
  21.  
  22.         $ tar -zxf griffith-<version>.tar.gz
  23.  
  24.     Switch to the newly created directory and type as root:
  25.     
  26.         # make install
  27.  
  28.     The Makefile will copy the files to the correct location in your
  29.     system. You do not need to configure or compile Griffith as it is
  30.     written in interpreted Python code.
  31.  
  32.     You can test Griffith without installing it:
  33.  
  34.         $ cd griffith-version
  35.         $ ./griffith --home /tmp/griffith
  36.  
  37. 1.3 Installing from downloaded package
  38.  
  39.     If you have downloaded Griffith package, just do as root:
  40.  
  41.     * deb packages (Debian, Ubuntu, ...)
  42.  
  43.         # dpkg -i griffith_<version>_all.deb
  44.  
  45.     * rpm packages (Redhat, Fedora, Mandrake, ...)
  46.  
  47.         # rpm -Uvh griffith_<version>.rpm
  48.  
  49. 1.4 Making Debian package
  50.  
  51.     If you want to make your own Debian package, follow these steps:
  52.  
  53.     * change your working directory to griffith source
  54.     * edit debian/changelog file, f.e. like this:
  55.  
  56.         $ dch -v <version> -D UNRELEASED -i NOT RELEASED YET
  57.  
  58.     * type `debuild` or `dpkg-buildpackage -rfakeroot` to build package
  59.     * install new package (`dpkg -i ../griffith_<version>_all.deb`)
  60.  
  61. 2. Microsoft Windows systems
  62. ============================
  63.  
  64. 2.1 Installing using the installer
  65.  
  66.     Just run the griffith installer available for your system.
  67.     A separated GTK+ Runtime Environment for Win32 is NOT necessary.
  68.     For now, Griffith is only known to work under Microsoft Windows XP
  69.     Professional Edition but should work on other windows flavours too.
  70.     
  71. 2.2 Compiling and making a custom installer
  72.  
  73.     2.2.1     This was tested with Griffith 0.9.7. Should work with later versions.
  74.             You will need the following packages installed on your system. You can grab them from the pointed urls:
  75.     
  76.             * Python         - python 2.5.1                   (http://www.python.org/download/)
  77.             * GTK Dev Env.   - gtk-dev-2.12.9-win32-2         (http://gladewin32.sourceforge.net/modules/wfdownloads/)
  78.             * PyGTK          - pygtk-2.12.1-2.win32-py2.5     (http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.10/)
  79.             * Glade 3        - glade-3.4.3-win32-1            (http://gladewin32.sourceforge.net/modules/wfdownloads/viewcat.php?cid=2)
  80.             * PyCairo        - pycairo-1.2.6-1.win32-py2.5    (http://ftp.gnome.org/pub/GNOME/binaries/win32/pycairo/1.2/)
  81.             * PyGObject      - pygobject-2.12.3-1.win32-py2.5 (http://ftp.gnome.org/pub/GNOME/binaries/win32/pygobject/2.12/)
  82.             * ReportLab      - ReportLab_2_1                  (http://www.reportlab.org/downloads.html#dlls)
  83.             * winshell       - winshell-0.2                   (http://timgolden.me.uk/python/winshell.html)
  84.             * PIL            - PIL-1.1.6.win32-py2.5          (http://www.pythonware.com/products/pil/#pil116)
  85.             * py2exe         - py2exe-0.6.8.win32-py2.5       (http://sourceforge.net/project/showfiles.php?group_id=15583&package_id=35995&release_id=474800)
  86.             * Python For Windows Extensions (pywin32) - pywin32-211.win32-py2.5 (http://sourceforge.net/project/platformdownload.php?group_id=78018)
  87.             * SQLAlchemy     - SQLAlchemy-0.3.10              (http://www.sqlalchemy.org/download.html)
  88.             * PyXML          - PyXML-0.8.4                    (http://downloads.nerdynick.org/files/Python/PyXML-0.8.4.win32-py2.5.exe)
  89.             * psycopg2       - psycopg2-2.0.6.win32-py2.5     (http://www.stickpeople.com/projects/python/win-psycopg/#Version2)
  90.             * MySQLPython    - MySQL-python-1.2.2.win32-py2.5 (http://sourceforge.net/project/showfiles.php?group_id=22307&package_id=15775&release_id=491012)
  91.             * Python-chardet - chardet-1.0                    (http://chardet.feedparser.org/download/)
  92.             * Python SQLite  - pysqlite-2.3.5.win32-py2.5     (http://www.initd.org/tracker/pysqlite/wiki/pysqlite)
  93.             * Inno Setup     - isetup-5.2.3                   (http://www.jrsoftware.org/isdl.php)
  94.             
  95.     2.2.2    After installing all the above packages, get griffith from SVN
  96.             or download the latest source tarball from the official site (http://www.griffith.cc/)
  97.             
  98.     2.2.3    Put the whole Griffith tree under "c:\griffith"
  99.     
  100.     2.2.4    Open a command prompt window and type:
  101.     
  102.             - cd c:\griffith
  103.             - winsetup.bat
  104.             
  105.     2.2.5    When the process is finished, locate 'c:\griffith\winpackage.iss' file using the explorer, 
  106.             right click it and choose 'compile'. This will create a single file installer 
  107.             using Inno Setup application.
  108.             
  109.     2.2.6     You can find the final installer in 'c:\griffith\installer'
  110.  
  111. 3. Apple MacOSX
  112. ===============
  113.  
  114. 3.1 Installing from source
  115.  
  116.     These setup guides were tested on MacOSX 10.4.x
  117.     
  118.     3.1.1     Download and install DarwinPorts
  119.             from http://darwinports.opendarwin.org/getdp/
  120.     
  121.     3.1.2     Open a terminal window and syncronize DarwinPorts' port tree 
  122.             with 'sudo port -d selfupdate'
  123.  
  124.     3.1.3     Then we need to install XCode that will provide us somes required 
  125.             tools, like a compiler :) You can find it on your original MacOSX 
  126.             disk or download it from http://developer.apple.com/tools/download/ 
  127.             Be aware that this is a very big download - almost 1 Gb. 
  128.             Pick version 2.4 or later.
  129.  
  130.     3.1.4     Type 'sudo port install py-gtk2' 
  131.             (this will install all the dependencies needed to pygtk and will 
  132.             take a while to complete)
  133.             
  134.     3.1.5     Install PIL typing 'sudo port install py-pil'
  135.  
  136.     3.1.6     Install Reportlab typing 'sudo port install py-reportlab'
  137.  
  138.     3.1.7     Install pysqlite2 typing 'sudo port install py-sqlite2'
  139.     
  140.     3.1.8    Then you will need to install at least version 0.3.1
  141.             of py-sqlalchemy from http://www.sqlalchemy.org/ because darwin
  142.             ports doesn't provide a recent version of this library.
  143.             So, download it, untar it and from the inside of the package
  144.             directory type: 'sudo python setup.py install'. Probably you will 
  145.             need to upgrade setuptools to 0.6c3 version as well during 
  146.             this process.
  147.             
  148.     3.1.9     Last but not least, you will need a X11 server because gtk is not 
  149.             native yet on the MacOSX. Use the Apple's X11 server because 
  150.             it will be much easier to configure. If not already installed you 
  151.             can find it on your MacOSX install dvd.
  152.  
  153.     3.1.10    To run Griffith just type 'open-x11 griffith' on terminal
  154.             to see if all is working as expected.
  155.  
  156.     Note:     If you get an error when trying to run Griffith regarding
  157.             a problem with module gtk.glade, try to delete py-gtk2 and 
  158.             install it again. This is because py-gtk2 was build before libglade.
  159.             Type 'sudo port uninstall py-gtk2'
  160.             and then 'sudo port install py-gtk2'. This fixes the problem.
  161.             
  162. 3.2 Installing from dmg package
  163.  
  164.     Not yet.
  165.